.. _cmmMxIsDone:

cmmMxIsDone
==============
--------------

SYNOPSIS
`````````

.. code-block:: none

    VT_I4 cmmMxIsDone(
        [in] VT_I4 NumAxes, [in] VT_PI4 AxisList, [out] VT_PI4 IsDone
        )


DESCRIPTION
`````````````

- 여러 개의 축에 대하여 지정한 모든 축의 모션이 완료됐는지를 확인합니다. 이 함수는 다축제어뿐 아니라
  원점복귀나 단축모션제어 작업시에도 활용할 수 있습니다.

PARAMETER
```````````

- NumAxes : 동시에 작업을 수행할 대상 축의 수

\

- ChannelList : 작업완료를 확인할 대상 축의 배열 주소값. 이 배열의 크기는 NumAxes 값과 일치하거나 커야합니다.

\

- IsDone : 다축구동 완료 여부를 판단할 수 있는 매개변수 입니다.


.. csv-table:: 
    :widths: 10 85
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    cmFALSE, 모션작업이 완료되지 않음
    cmTRUE, 모션작업이 완료됨

    
RETURN VALUE
`````````````

+--------------+-----------+
| Value        | Meaning   |
+==============+===========+
| 음수         | 수행 실패 |
+--------------+-----------+
| cmERR_NONE   | 수행 성공 |
+--------------+-----------+


EXAMPLE
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 long nIsDone;
 long nAxisList[2] = {cmX1, cmY1};
 double fDistList[2] = {1000, 1000};

 if(cmmMxMove(2, nAxisList, fDistList, cmFALSE) != cmERR_NONE){
        //Handle 은 사용자가 생성한 폼의 핸들 값입니다.
        cmmErrShowLast(Handle);
        return;
 }

 while (1){
    cmmMxIsDone(2, nAxisList, &nIsDone); 
    if(nIsDone == cmTRUE) break;
    else{
        // 다축 모션이 종료되지 않은 경우입니다. 적절한 처리를 합니다.
    }
 }


.. code-block:: none
 :linenos:
 
 Visual Basic

 Dim nAxisList(2) As Long
 Dim fDistList(2) As Double

 ‘ 대상 축 설정
 nAxisList(0) = cmX1
 nAxisList(1) = cmY1

 ‘ 대상 축에 대한 이송 거리 설정
 fDistList(0) = 1000
 fDistList(1) = 1000

 If(cmmMxMove(2, nAxisList(0), fDistList(0), cmFALSE) <> cmERR_NONE) Then
    Call cmmErrShowLast(Handle) ‘에러처리
    Exit Sub
 End If

 While(cmmMxIsDone(2, nAxisList(0), cmTRUE) <> cmERR_NONE)
    Call cmmErrShowLast(Handle) ‘에러처리
    Exit Sub
 End If


.. code-block:: none
 :linenos:
 
 Delphi

 // 대상 축 설정
 nAxisList[0] := cmX1;
 nAxisList[1] := cmY1;

 // 대상 축에 대한 이송 거리 설정
 fDistList[0] := 1000;
 fDistList[1] := 1000;

 if(cmmMxMove(2, @nAxisList, @fDistList) <> cmERR_NONE) then begin
    cmmErrShowLast(Handle);
    // 에러 발생에 대한 적절한 처리를 수행합니다.
 end;

 while(cmmMxIsDone(2, @nAxisList, @IsDone) <> cmERR_NONE) do begin

    // 여기서 IsDone 이 cmTRUE 이면 Loop 를 탈출하면 됩니다.
    …
 end;

 if(cmmErrGetLastCode() <> cmERR_NONE) then begin
    cmmErrShowLast(Handle);
    // 에러 발생에 대한 적절한 처리를 수행합니다.
 end;






.. seealso:: :ref:`cmmMxWaitDone`